home *** CD-ROM | disk | FTP | other *** search
/ Mission 3 / Mission 3.zip / Mission 3.iso / spiele / clowns / readme.doc < prev    next >
Text File  |  1996-09-18  |  9KB  |  189 lines
  1. Monkeys and Balloons
  2. by Frank Cohen
  3. (c) 1988 Regent Software
  4.  
  5. This document and the program that accompanies it is owned
  6. by Regent Software with all right reserved.  Please feel free
  7. to makes copies of the program for your local user group, Atari
  8. ST dealer, and friends.  However, under no circumstance is this
  9. program to be sold as a commercial product.
  10.  
  11.  
  12. A long, long time ago...
  13.  
  14. Once upon a time, a young college freshman found a company that
  15. would pay him the exorbitant salary of fourteen dollars an hour
  16. to sit in front of an Atari 800 and write a computer game. He
  17. didn't know a thing about writing a game, but he was a trained
  18. graphic artist, and had some experience writing music.  So he
  19. gave it a whirl.  Six months later Datasoft, Inc., released one
  20. of its first games: Clowns and Balloons.
  21.  
  22. Since then, the freshman went on to work for other companies, and
  23. eventually founded his own computer software company that
  24. currently offers ST products.  But, the name Clowns and
  25. Balloons haunted him as his first, and probably best known
  26. work.
  27.  
  28. Years later, when the Atari 800 found itself put out to pasture,
  29. the idea of writing a new version of Clowns and Balloons kept
  30. coming up.  The publishers of ST-Log magazine found with the
  31. right amount of coaxing, that Clowns and Balloons would
  32. finally see the light of day on the ST computer.  A deal was
  33. struck, and some work began.  But it took more than a year for
  34. the project to be completed - while the project was fun to work
  35. on, it didn't pay the monthly bills.
  36.  
  37. When Clowns and Balloons ST was finished, the name just didn't
  38. suit it anymore.  The graphics were completely different, the
  39. game play more difficult, the music was rewritten, and some of
  40. the animation was changed.  So, we are proud to bring you
  41. Monkeys and Balloons.
  42.  
  43. Required Hardware
  44.  
  45. Monkeys and Balloons will run on any Atari ST computer: Atari
  46. 520ST, 1040ST, Mega 2 and Mega 4 systems.  The game uses your
  47. ST's mouse as its joystick, controlling player movement. The
  48. program is designed to run in Low Resolution mode, so a color
  49. monitor is required.
  50.  
  51. Starting The Game
  52.  
  53. From the GEM Desktop, open the filed titled MONKEYS.PRG.  You
  54. can open a file by clicking the program icon once, then
  55. selecting the OPEN option from the FILE drop down menu.
  56. You may also double-click the program icon.
  57.  
  58. Once the program is started, the title screen will appear and you
  59. will hear some music.  The music volume is controlled from your
  60. color monitor's volume control knob.
  61.  
  62. After a few moments a demonstration of the game play will appear.
  63. While either viewing the title screen or the demonstration,
  64. clicking the left mouse button will start a new game.
  65.  
  66. Game Play
  67.  
  68. Welcome to the exciting world of the circus.  Cotton candy,
  69. peanuts, clowns, and balloons are all waiting for your enjoyment.
  70. Funny clowns bounce through the air, while trained monkeys
  71. carefully balance a trampoline close to the ground.  Move the
  72. trampoline below the clown and everything is fine.  The clown
  73. bounces higher and higher, trying to catch some of the floating
  74. balloons.  Miss the clown, and you won't get any bananas
  75. tonight!
  76.  
  77. As the monkey trainer, you control which way the monkeys move
  78. the trampoline by moving the ST's mouse left and right.  The
  79. monkeys can control where the clown will bounce by moving the
  80. trampoline slightly when the clown bounces.  The clown will
  81. bounce straight up and down, if he lands right in the center of
  82. the trampoline.  The further from the center, the more of an
  83. angle.
  84.  
  85. There are three rows of floating balloons above the monkeys. When
  86. the clowns hat touches a balloon, it pops and you are awarded
  87. some points.  The higher the balloon, the more points are
  88. awarded.  The object of the game is to clear each row of
  89. balloons from bottom to top.  If you clear the second or third
  90. row of balloons before clearing the bottom row, the higher rows
  91. will fill up again with more balloons.  When you clear all of the
  92. balloons, a special bonus award will be given and the next level
  93. will begin.
  94.  
  95. At first, the clown will not bounce very high.  The longer the
  96. clown continues to bounce, the higher he will go.  The clown also
  97. bounces faster as the game is played.
  98.  
  99. Exiting The Game
  100.  
  101. While the game is being played, pressing the SPACE bar will
  102. terminate the program and return you to the GEM Desktop.  You
  103. may also press the UNDO key to finishing playing the game.
  104.  
  105. Hints For Game Designers
  106.  
  107. Monkeys and Balloons stores the color palette in use when the
  108. program is first started.  The program then switches the
  109. resolution of the screen to low resolution, storing the current
  110. resolution.  When exited, Monkeys and Balloons restores the
  111. resolution and color palette.  This should be standard practice
  112. for all games on the ST, but this is rarely the case.
  113.  
  114. The project was written using Regent Word 1 as a text editor.  As a
  115. program editor, Regent Word is superior to the other text editors
  116. available because everything can be keyboard driven.  The mouse
  117. is useless to program developers because keyboard commands don't
  118. force you to take your hands off the keyboard, which slows down
  119. your development efforts.
  120.  
  121. William Robinson has developed his own home-brew 68000 Assembler
  122. program, which was of invaluable help to completing this project
  123. in a relatively short amount of time.  William's assembler takes
  124. standard 68000 code and turns it directly into a .PRG program
  125. file, ready for running from the GEM Desktop.  Other assemblers
  126. have to go through two or three steps before they are finished.
  127. Atari Corp. has released their own quick-and-easy 68000
  128. Assembler, but I found William's to be easier to use and quicker.
  129. William's assembler compiles the Monkeys and Balloons source
  130. code in under eight seconds!  The only problem with William's
  131. assembler is that it has not been released to the public.
  132. William does not want to support it, so for the moment it isn't
  133. available.  However, William is easily swayed to public opinion,
  134. so writing him a letter might change his opinion.
  135.  
  136. All of the graphics were developed using Degas Elite.  The
  137. graphic files are stored in the normal Degas compressed
  138. format.  When the program is run, all of the graphic files are
  139. loaded into the ST's memory and decompressed.  The decompression
  140. routine took only a few hours to write, and can easily be used in
  141. other programs.  Since the files are Degas compatible, you can
  142. easily create your own graphics for the game.  If you develop
  143. something funny or cute, be certain to send a copy to
  144. ST-Log.
  145.  
  146. The music routines turned out to be the most difficult part of
  147. the project. The note and duration of the music was developed by
  148. hand-coding the songs from their original sheet music. Certainly
  149. other methods of capturing music data are possible with the ST,
  150. but at the time none were known.  Once the notes were entered,
  151. the problem of how to generate sounds become a problem.  Atari's
  152. ST documentation is completely void of any information on sound
  153. generation for the ST.  Michtron's Concise Guide To the Atari
  154. ST book showed how to create a frequency, but said nothing
  155. about generating notes from a musical scale.  Finally, a friend
  156. found a small table of frequency to note values in the Abacus
  157. ST Graphics and Sound book.
  158.  
  159. The entire project took less than three weeks of full-time effort
  160. to complete.  The graphics were developed in about five days,
  161. with the balance of the effort spent on programming and
  162. debugging.
  163.  
  164. If you have any ideas or feedback on the game, please send them
  165. to ST-Log.  There is a whole library of games like Monkeys and
  166. Balloons that could be developed with the right encouragement!
  167.  
  168.  
  169. Version 2
  170.  
  171. After the first release of Monkeys and Ballons, many Mega ST
  172. owners reported the program bombs back to the GEM Desktop
  173. during game play.  The problems was in the DEAD routine, which
  174. paints the crumbed Clown onto the screen.  The routine
  175. accidentally painted the Clown off the bottom of the screen.
  176. On a Mega 4 ST, this means the Clown is painted beyond the
  177. valid (legal) memory limits.  Thus a 2 bomb, memory error, would
  178. appear causing the program to terminate to the Desktop.
  179.  
  180.  
  181. ---
  182.  
  183. About the author:  Frank Cohen has been writing Atari software
  184. since Clowns and Balloons, his first 8-Bit game. He founded
  185. Regent Software in 1985, and has recently completed
  186. Regent Base 2: 4GL SQL Database for the ST and Mega computers.
  187. He can be reached directly on Compuserve, Delphi and Genie.  Or
  188. by writing to him at P.O. Box 14628, Long Beach, CA 90803.
  189.